chore: 배포 설계 문서 · 운영 이미지 Dockerfile · CI 이미지 빌드 확인 (#88) - #97

관련 이슈

• closes [chore] Dockerfile·이미지 빌드 확인 + 배포 설계 문서 #88

작업 내용

배포 설계 문서 (docs/deploy-design.md)

• 도커 이미지 → GHCR → EC2 한 대(compose) 배포 구조와 각 결정의 근거(상황 → 선택지 → 고른 것 → 대가)
• 배포 흐름(main 병합 → 이미지 푸시 → OIDC → SSM 명령 → 상태 확인 → 실패 시 이전 태그로 되돌리기), 구성도·순서도
• 환경 변수·비밀값 목록, 월 비용 추정(약 $42), 출시 전 → 출시 전환 절차, 2027-01-17 계정 처리(유료 전환)
• 정한 것: 프론트 주소 sniptext.kr·API api.sniptext.kr, 예산 $60(크레딧 제외), 앱 전용 DB 계정 분리, 출시 전 승인자 끔
• 이후 구현 이슈 [chore] 테라폼 bootstrap(상태 저장소) + 예산 경보 #89 ~ [chore] (후속) 단일 서버 무중단 배포 + 마이그레이션 호환 규칙 #96

운영 이미지 (Dockerfile, .dockerignore)

• 빌드 단계·실행 단계 분리, 자바 21(temurin noble), 기본 이미지는 태그 + 다이제스트 고정
• 빌드 단계는 빌드하는 기계의 아키텍처에서 실행, 실행 단계에는 RUN이 없음 → x86에서도 에뮬레이터 없이 arm64(EC2 t4g) 이미지 빌드
• jar를 층별(의존성 → 로더 → 앱)로 풀어 넣어 코드만 바뀌면 마지막 층만 다시 받음
• 비루트 실행(기본 이미지의 uid 1000), TZ=Asia/Seoul
• JVM 메모리 옵션은 실행 시 JAVA_TOOL_OPTIONS로 받음 ([chore] 서버 실행 구성: compose 운영 파일·Caddy·배포 스크립트(상태 확인·되돌리기) #92)

CI (ci.yml)

• 기존 빌드와 나란히 도는 image 작업 추가: x86 실행기에서 arm64 이미지 빌드 확인(푸시 없음)
• 새 액션 docker/setup-buildx-action@v4: 다른 아키텍처 빌드용 빌더 설정

명세와 달라진 점

없음 (API 변경 없음)

테스트

• 로컬 이미지 빌드 → local 프로필 + compose MySQL로 실행 → /actuator/health UP (10.7초 기동)
• 컨테이너 안 id → uid=1000(ubuntu), date → KST, 로그 시각 +09:00
• docker buildx build --platform linux/arm64 성공, 이미지 아키텍처 arm64 확인
• ./gradlew build 통과

확인 체크리스트

• ./gradlew build 통과
• 테스트 포함 — 코드 변경 없음 (이미지 실행 확인은 위 테스트 항목)
• 변경 400줄 안팎 — 443줄, 그중 설계 문서가 372줄 (코드·설정은 71줄)
• 병합된 마이그레이션 수정 안 함
• 비밀 값·개인정보 없음
• global 공통 코드 변경 없음

리뷰어에게

• 비루트 사용자를 새로 만들지 않고 기본 이미지의 ubuntu(uid 1000)를 쓴 이유: 사용자를 만들면 실행 단계에 RUN이 생겨 arm64 빌드에 에뮬레이터가 필요해집니다
• 설계 문서 11절 "정한 것"을 봐 주세요 (유료 전환, 예산, 앱 전용 DB 계정 등)
• 새 CI image 작업이 이 PR에서 처음 실행됩니다